Currently the Images Binding only supports info and transform operations. This PR introduces support for the following Hosted Images endpoints that are already available via the images api:

• List Images
• Image Details
• Upload Image
• Update Image
• Delete Image

The images binding has recently been switched to a direct binding, so whilst info and transform are still handled by fetcher.fetch the new endpoints for managing Hosted Images pass through via RPC.

Sample implementation

Once released, we'd expect users to be able to write worker code that looks something like

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    // Upload an image
    const imageData = await fetch('https://example.com/photo.jpg');
    const uploaded = await env.IMAGES.hosted.upload(imageData.body!, {
      filename: 'photo.jpg',
      metadata: { source: 'example' },
    });

    // List images
    const list = await env.IMAGES.hosted.list({ limit: 10 });
    console.log('Images:', list.images.length, 'Complete:', list.listComplete);

    // Update image
    const updated = await env.IMAGES.hosted.update(uploaded.id, {
      metadata: { source: 'example', edited: true },
    });

    // Get image metadata
    const metadata = await env.IMAGES.hosted.details(uploaded.id);
    console.log('Got:', metadata?.filename);
    
    // Delete image
    const deleted = await env.IMAGES.hosted.delete(uploaded.id);
    console.log('Deleted:', deleted);
    return new Response('Done!');
  },
};

Reviewer Considerations

• This change is coupled tightly with our upstream images api change. A decision has been made to try and keep as much logic in the upstream as possible with the only new upload method having having a non trivial implementation (to leverage workerd's base64 decoding support)
• In the future we may also want to do away with images-api.ts in its entirety and move the existing transformation logic into our upstream images api
• After discussion with the team we've opted to go for namespacing the new methods so that they are accessed as follows env.IMAGES.hosted.list(). We are hopeful that will more clearly disambiguate their function to users and give us more flexibility on the addition of new methods to the binding in the future.

Next Steps

• We still need to make the edgeworker config service inject the accountId into ctx.props
• Workers sdk / wrangler / miniflare support